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Abstract 

LilyPond [Nienhuys and et al., 2010] and RTpX pro¬ 
vide excellent free tools to produce professional mu¬ 
sic scores ready for print and sale. Here we present 
the OrchestralLily package for LilyPond, which sim¬ 
plifies the creation of professional music scores with 
LilyPond and MUX even further. All scores are gen¬ 
erated on-the-fly without the need to manually spec¬ 
ify the structure for each individual score or part. 
Additionally, a RTpX package for the prefatory mat¬ 
ter is available and a templates system to create all 
files needed for a full edition is implemented. 
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1 Introduction 

In professional music publishing applications 
like Finale, Sibelius and SCORE are the pre¬ 
dominant software packages used. However, the 
open source applications LilyPond and DTgX 
provide excellent free alternatives for producing 
professionally looking music scores, as well. To 
ease the production of such scores even further, 
we developed a package called OrchestralLily for 
LilyPond and DTpjX. Instead of having to pro¬ 
duce each score and instrumental part manually 
in LilyPond, this package produces these scores 
dynamically from the music definitions. 

2 A Short Introduction to LilyPond 

LilyPond, the music typesetting application de¬ 
veloped under the umbrella of the GNU project, 
is a WYSIWYM (’’What you see is what you 
mean”) application, taking text files containing 
the music definitions and corresponding settings 
and typesetting it into a PDF file. Writing a 
LilyPond score is very similar to coding a soft¬ 
ware program. 

In this section we will give a very short 
overview about the LilyPond syntax, mainly to 
highlight our motivation to create the Orches¬ 
tralLily package, which creates the scores dy¬ 


namically. Fore a more detailed overview over 
LilyPond we refer to the excellent Documen¬ 
tation of the LilyPond project: http://www. 
lilypond.org/Documentation/. 

A very simple LilyPond score containing only 
one staff has the following form: 

\ version ”2.13.17” 

\relative c’’ { 

c4\p d8[( c]) e4 —. d—. | 
cl \bar ” | . ” 

} 



All notes are entered by their note name 1 , 
followed optionally by the duration and addi¬ 
tional information like beaming ([ and ]), dy¬ 
namics (e.g. \p) and articulations (e.g. -. for 
staccato). When running this file through the 
LilyPond binary, a five-line staff with a treble 
clef, 4/4 time signature and C major key is im¬ 
plicitly created. All layouting and spacing is 
done by LilyPond according to best practices 
and standards from music engraving. 

2.1 Writing Full Scores in Pure 
LilyPond 

To produce a score containing a system with 
more than one staff (e.g. full orchestral scores, 
choral scores or vocal scores) or to produce a 
score with lyrics attached to the notes, LilyPond 
can no longer automatically create the staves, 
but one has to write the score structure manu¬ 
ally into the LilyPond file: 

\ version ”2.13.17” 

sopmusic = \relative c’’ { 

c4\p d8 [ ( c ]) e4 —. d—. | c.1 \bar ”|.” } 

soplyrics = \lyricmode { Oh, be __ hap — py 
now! } 

1 Using Dutch names by default: b for the note below 
c and the postfix -is for sharp alterations and -es for 
flat alterations. Other languages can easily be used by 
including a language file, e.g. (include "english. ily". 




















Here, the actual music definitions require only 
eight lines of code, while the structure of the 
score requires already more lines. 

As one can image, creating a full orches¬ 
tral score with lots of instruments and multi¬ 
ple movements quickly becomes a nightmare to 
produce manually. Each staff and each staff 
group defined this way takes 3 to 7 lines of code, 
quickly leading to a score structure definition of 
hundreds of lines. For example, a large work 
with 23 instruments and 12 movements has 276 
individual staves, not counting groups. Even 
worse, each movement typically has the same 
well-defined structure in the orchestral score. 
So, a lot of code is duplicated, with the only 
difference being the music expressions inserted 
into the scores. 

This makes it extremely hard to maintain 
large orchestral scores in pure Lily Pond, and 
even small changes to the appearance of only 
one instrument require lots of changes. 

2.2 C-|—[- and Scheme / Guile 

Internally, LilyPond is written in C++ with 
Guile as embedded scripting language. Many 
parts of the formatting code (e.g. all graphi¬ 
cal objects like note heads, staff lines, etc.) are 
defined in Guile and can be modified and over¬ 
written easily using Scheme code embedded into 
the score. LilyPond even provides an extensive 


Scheme interface to most of the functions re¬ 
quired to create a score. This interface is the 
key for our OrchestralLily package, where all 
scores are generated on-the-fly using Scheme. 

3 OrchestralLily: An easy example 

OrchestralLily uses a slightly different approach 
than manually writing LilyPond scores: Instead 
of telling LilyPond explicitly about staves and 
groups, the score structure is already built in, 
using default names, and the user only has to 
define some specially-named variables, contain¬ 
ing the music, lyrics, clef, key, special settings, 
etc. The score is then generated on-the-fly by 
the following call: 2 

\createScore ^’’MovementName” 

#’(” Instrument 1 ” ”Group2” ” Instrument2 ” ) 

Of course, multiple \createScore commands 
can be given in a file to produce multiple scores 
in the same file (in particular, this is used in 
large works with multiple movements, where all 
movements should be printed sequentially). 

The specially-named variables holding the 
music definition mentioned above have the form 

[MovementName] InstrumentMusic 

where Instrument is replaced by the (de¬ 
fault) abbreviation of an instrument or vocal 
voice and [MovementName] is optional for pieces 
with only one movement. To define a spe¬ 
cial clef, key, time signature, lyrics or spe¬ 
cial settings for a voice, one simply defines a 
variable containing the clef, key, time signa¬ 
ture, etc. This special variable for each instru¬ 
ment is called [MovementName] InstrumentXXX, 
where XXX is either Clef, Key, TimeSignature, 
Lyrics, ExtraSettings, etc. 

To show how this works, the two-voice exam¬ 
ple from above using OrchestralLily will now 
look like: 


\ version ”2.13.17” 


\include ” orchestrallily / orchestrallily . ily” 

SMusic = \relative c’’ { 


c4\p d8[( c]) e4 —. d—. | 

cl \bar ” | ” } 

SLyrics = \lyricmode { 


Oh, be __ hap — py now! 

} 

AMusic = \relative c’’ { 


g4 f4 e4 f | el \bar ” | . 

” i 

ALyrics = \lyricmode { 


Oh, be hap — py now! } 


\createScore #”” #’(”S” ”A’ 

) 


2 The hash sign # indicates a scheme expression, the 
#’(...) is a list in Scheme syntax. 
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It is clear that this automatic creation of 
staff groups saves a lot of effort for large- 
scale orchestral projects. It should be noted 
that OrchestralLily has a large hierarchy of 
orchestral instruments, including the identifier 
"FullScore" for a full orchestral score. So in¬ 
stead of #’ ("S" "A") above, we could have also 
said #’ ("FullScore") to generate a full score 
of all defined voices. Voices not defined will be 
ignored, so # , ("S" "A" "T" "B") would have 
the same output, as the T and B voices are not 
defined and thus not included in the output. 

4 Structure of a Score 

To understand OrchestralLily’s approach, we 
have to take a closer look at the organization of 
a full score. A music score has an intrinsic hier¬ 
archy of instruments and instrument groups, as 
shown in Figure 1. 

This hierarchy is pre-defined in Orchestral- 
Lily and will be used, unless the LilyPond score 
explicitly overrides it: 

• The instruments are named by their stan¬ 
dard abbreviation (e.g. “V”, “VI”, etc. 

for violins, “Fag”, “FagI” etc. for bas¬ 
soon, “Ob” for oboe, “S”, “A”, “T”, “B”, 
“SSolo” etc. for vocal voices, etc.). 

• Each group of instruments has a pre¬ 
defined name: “Wd” for woodwinds, “Br” 
for the brass instruments, “Str” for strings 
(except continuo, i.e. celli and basses, 
which are typically not included in the 
strings group, but placed at the bottom of 
a full score), “Choir”, “Continuo”, etc. 

• Several types of scores are pre¬ 
defined: “LongScore”, “FullScore” (like 
“LongScore”, except that two instruments 
of the same type, e.g. Obi and Obll, are 
combined and share one staff rather than 
using separate staves), “VocalScore” (only 
the vocal voices and the piano voice), 
“ChoralScore” (only the vocal voices, no 
instruments). 

The score types pre-defined in OrchestralLily 
adhere to the standard instrument order usually 
employed for full orchestral scores. 
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Figure 1: Hierarchy of an orchestral score 


5 More complex examples 

The examples so far placed the music definition 
and the actual score creation via \createScore 
into the same file. For larger projects, it is 
advisable to place the music definitions into a 
separate file, as we need several different score 
files, each of which will include this defini¬ 
tions file. All the examples in this section will 
use the following music definition file “music- 
definitions.ily”, which defines a flute, a violin, 
soprano and alto, as well as a continuo part for 
a movement named Cadenza. Also, a Piano re¬ 
duction is defined in this file. Notice also, that 
this include file already loads OrchestralLily, so 
we don’t have to do this again in the file for each 
individual score. 

\include ” orchestrallily / orchestrallily . ily” 
\ include 

” orchestrallily / oly_settings_names . ily” 
\header { 

title = ”A cadenza” 

} 

CadenzaPieceNameTacet = ’’Cadenza tazet” 









































































































A cadenza 


% Flute and Violin : 

CadenzaFlIMusic = \relative c’’ { e4 a g b, 

| cl \bar } 

CadenzaVIMusic = \relative c’’ { 
cl6 [ e g e ] d [ f a f ] e [ g e c ] b [ d b g] | 
cl \bar 

} 

% The vocal voices: 

CadenzaSMusic = \relative c’’ { 

c4\p d8[( c]) e4 —. d-. | cl \bar } 

CadenzaSLyrics = \lyricmode { 

Oh, be __ hap — py now! } 

CadenzaAMusic = \relative c’’ { 
g4 f4 e4 f | el \bar } 

CadenzaALyrics = \lyricmode { 

Oh, be hap — py now! } 

% Continuo : Organ / Celli / Bassi / Bassoon 
CadenzaBCMusic = \ relative c { c4 f4 g g, | 

cl \ bar ” | ” } 

CadenzaFiguredBassMusic = \figuremode { 
s4 <6>8 <5> <6 4>4 <5 3> | si 

} 

% Piano reduction : 

CadenzaPIMusic = \relative c’’ { 

\twoVoice { 

cl6 [ e g e] d[ f a f] e[ g e c] b[ d b 

g] i 

} { 

e4 a <g c>4 <b f>4 

} | % 2 

<c g e>l \bar ” | 

} 

CadenzaPIIMusic = \relative c { 

<c g’>4 f <g c>4 <g d’> | % 2 
<c c, >1 \ bar ” | ” 

} 


All variables in this file start with Cadenza, 
followed by the instrument name, which is how 
OrchestralLily detects that these definitions be¬ 
long to a movement name Cadenza. We also 
defined a piece title to print before the score. 

Another thing to notice here is that 
we also include the file “orchestrallily/ 
olyjsettings_names.ily”. That file contains 
many instrument and score name definitions 
for most common instruments and causes them 
to be printed before each staff in the score. 

5.1 The Full Score 


\version ”2.13.17” 

\ include 

” orchestrallily / oly_settings_fullscore . ily 
\include ” music —definit ions . ily” 
\setCreateMIDI 
\setCreatePDF 

\createScore ^’’Cadenza” #’(” FullScore ” ) 



The additional \setCreateMIDI ##t line 
causes a midi file of the score to be created in 
addition to the PDF file. 

Notice that we never explicitly said that the 
continuo is supposed to be in bass clef. Orches- 
tralLily already knows that the “BC” (Basso 
continuo) voice is in bass clef! Similarly, trom¬ 
bone parts will employ the correct C clef, the 
choir bass will also use the bass clef, etc. 

If some instruments should have cue notes, we 
don’t want to print them in the full score, so in¬ 
stead of \createScore, OrchestralLily provides 
the command \createNoCuesScore, which will 
additionally remove all cue notes from the 
printed score. 

5.2 Instrumental Parts 

Each instrumental part can be generated just 
like the full score. If one additionally defines the 
“instrument” header field, then the instrument 
name will be printed in the right upper corner, 
like in most printed scores. 

\ version ”2.13.17” 

\include ” music—definit ions . ily” 

\ include 

” orchestrallily/oly_settings_instrument . ily” 
\header { instrument = \VIInstrumentName } 

\createScore ^’’Cadenza” #’(”VI”) 

A cadenza ( ViolinoT] 



If no music is defined for the given instru¬ 
ment for the desired movement (indicated by 
the first string that you pass to createScore), 
OrchestralLily will instead print a “tacet” head¬ 
line. For example, if we try to create a score for 
the oboe, there is no oboe part defined and a 
“Cadenza tacet” is printed instead: 




A cadenza 


\version ”2.13.17” 

\include ” music —definitions . ily” 

\header { instrument = \ObllnstrumentName } 

\createScore ^’’Cadenza” #’(”ObI”) 


A cadenza [oboei] 

Cadenza tazet 


5.3 Vocal Scores and Modifying 
Individual Staves 

To create a vocal score (remember, we have al¬ 
ready defined the piano reduction in the defini¬ 
tions!), you only have to call \createScore for 
the “VocalScore” score type. To make things 
more interesting, here we want the staves for 
vocal voices to appear smaller than the piano 
staff. Furthermore, the note heads of the so¬ 
prano voice should be colored in red and the 
alto lyrics printed in italic. 

These special settings for S and A can 
be provided by placing them into \with 
blocks and saving them into appropriately 
named variables called Cadenza[SA] (Staff | 
Voice ILyrics)Modifications: 


(version ”2.13.17” 

\include ” music —definitions . ily” 

CadenzaSStaffModifications = \with { 
fontSize = #—3 

\override StaffSymbol st aff —space = 

#(magstep —3) 

} 

CadenzaASt affModificat ions = 

\ CadenzaS St affModificat ions 

CadenzaChSt affModificat ions = 

\ CadenzaSStaffModifications 

CadenzaALyricsModifications = \with { 
\override LyricText #’font— shape = 
i t a 1ic } 

CadenzaSVoiceModifications = \with { 

\override NoteHead #’color = #red } 

\createScore ^’’Cadenza” #’(” VocalScore” ) 



5.4 Figured Bass 

The continuo part in the music definitions above 
is simply the bass line of the cadenza. How¬ 
ever, most old scores additionally provide a bass 
figuration to indicate the harmonies to the or¬ 
ganist. Creating such a figured bass score is 
also extremely simple in OrchestralLily: All you 
have to do is to define its corresponding vari¬ 
able, named CadenzaFiguredBassMusic in our 
case, where you define the appropriate bass fig¬ 
ure in LilyPond’s \figuremode syntax: 

(version ”2.13.17” 

\include ” music—definitions . ily” 

CadenzaFiguredBassMusic = \figuremode { 
s4 <6>8 <5> <6 4>4 <5 3> | si 

} 

\createScore ^’’Cadenza” #’(” Continuo” ) 

A cadenza 

6 5 

_ 6 5 4 3 _ 

Organo V' « f - * ^-— n z | 


5.5 Cue Notes 

Suppose that we now want to add a second flute, 
which will set in on the third beat. In the instru¬ 
mental part, we want to print cue notes from the 
first flute, but in the full score (or in a combined 
flute part) we don’t want the cue notes. 

In LilyPond, one can simply create cue notes 
by first defining the music to be quoted via 
\addQuote and then inserting the cue notes via 
\cueDuring #"quotedInstrument" { r2 }. 

First, we add the new flute 2 part in a sepa¬ 
rate file “music-definitions-flute2.ily”: 


\addQuote #”Flutel 

” 

\ CadenzaFlIMusic 

CadenzaFlIIMusic = 

\ 

relative c ’ ’ { 

\namedCueDuring 

#” 

Flutel” #UP ”FI.1” 

” FI.2” { R1 

} 

1 

gl (bar ”|.” 



} 













































A cadenza 


Note that we quote the first flute directly 
in the music for the second flute, using the 
method \namedCueDuring (which is equivalent 
to LilyPond’s built-in function \cueDuring, ex¬ 
cept that it also adds the name of the quoted 
instrument). 

The Flute 2 part now simply is: 


\ version 

”2.13.17” 


\ include 

” music —definit ions . ily” 


\ include 

” music — definitions —flute2 . 

ily” 

% The Flute 2 part : 


\createScore ^’’Cadenza” #’(”F1II”) 



A cadenza 



In the full score (or a combined flutes part), 
however, we do not want to print the cue 
notes, since the notes from Flute 1 are already 
printed in the score. In this case, we can use 
\createNoCuesScore instead of\createScore 
to suppress the creation of any cue notes: 


\ version 

”2.13.17” 

\ include 

” music—definit ions . ily” 

\ include 

” music — definit ions —flute2 . ily” 

% remove 

the cues in Flute 2: 

\ createNoCuesScore ^’’Cadenza” #’(” FILong” ) 


Violino I 



• f f , | » f f f 

^ ^ ^^ jlip. .1 



5.7 Drum Staves and other staff types 

Of course, OrchestralLily is also able to print 
non-standard staves, like rhythmic staves or 
tablatures: 

\ version ”2.13.17” 

\include ” orchestrallily / orchestrallily . ily” 
\header { 

title = ’’Drum and tab staves” 
composer = ’’Anonymous” 

} 

drumIMusic = \drummode { crashcymbal4 hihat8 
halfopenhihat } 
drumllMusic = { c4 c4 } 
tabularMusic = { c4 <e g>8 dl6 rl6 } 

\orchestralScoreStructure #’( 

(’’drurnl” ’’DrumStaff” ()) 

(” drumll” ’’RhythmicStaff” ()) 

(’’tabular” ’’TabStaff” ())) 

\ orchest ral VoiceTy pes #’( 

(’’drurnl” ’’DrumVoice”) 

(’’tabular” ’’TabVoice”)) 

\createScore ^’’Cadenza” #’(”druml” ’’drumll” 

”tabular ”) 


Drum and tab staves 


A cadenza 


Flauto I I 


Flauto III 


TF 


■0- 


TF 


5.6 Transposition 

Parts can be easily transposed (e.g. for trans¬ 
posing instruments between concert pitch and 
written pitch): 


\version ”2.13.17” 

\include ” music —definitions . ily” 

% We need to give the key explicitly , 
% so that it will also be transposed : 
CadenzaVIKey = \key c \major 
% Transpose to g major 
CadenzaVITransposeFrom = g 

\createScore ^’’Cadenza” #’(”VI”) 


Anonymous 



6 Tweaking the Score 

As the OrchestralLily package is implemented 
entirely in LilyPond syntax and Scheme code, 
anyone can easily adjust or extend its function¬ 
ality directly in a score or in an include file, 
without the need to recompile or reinstall any¬ 
thing. 

7 for the Preface and Cover 

So far, we have concentrated on creating the 
musical score. A professional edition, however, 
also features a nice title page, a preface and in 
many cases also a critical report. For these, 








we chose IATpiX for typesetting together with 
a package providing a uniform layout, 

many macro definitions aiding with the criti¬ 
cal report and a beautiful title page. The music 
scores are directly included into the L^TgX file 
using the pdf pages package. 


The templates (see next section) provided by 
OrchestralLily already produce a beautiful lay¬ 
out without the need for any special tweaks. All 
one has to do is fill in the missing text and the 
general information about the score, and the 
IAI^]X scores will look like the following pages 
from a real score, typeset using OrchestralLily: 


Johann Strauss 

Serben-Quadrille 
Serbian Quadrille 

Op. 14 

Bearbeitung fur Streichtrio 
Arrangement for String Trio 


Partitur / Full Score 


Edition Kainhofer. Vienna. EK-2000-1 


Johann Strauss (1825-1899) 

Serben-Quadrille 
Serbian Quadrille 

Op. 14 


Bearbeitung fur Streichtrio 
Arrangement for String Trio 






























































































































































8 Generating a Template 

OrchestralLily also provides a template-based 
script to generate all files required for a full edi¬ 
tion of a score: The score information, including 
instrumentation, movements, voices with lyrics, 
etc., are defined in one input file. After running 
the generate_oly_score. py script, one has the 
full set of files for the edition, including a Make¬ 
file. Only the music, lyrics, and the actual text 
of the preface and the critical report need to be 
filled in. Running make will always update all 
scores and produce ready-for-print files for all 
desired scores and instrumental parts. 

A typical input file for the cadenza example 
used above is shown here: 



Running this file through the script generates 
one definitions file for the music definition, Lily- 
Pond files for each of the given scores (Full, vo¬ 
cal and choral scores), as well as for each in¬ 
dividual instrumental part. Each of the scores 
will also have a UTj^X file that includes the ti¬ 
tle page, the preface (including the table of con¬ 
tents, which is exported by LilyPond!), the score 
and optionally a critical report. 

All these files are tied together via a Makefile, 
so all one needs to do to create a first version is 
to copy in the music definition and run make. 

9 Availability of OrchestralLily 

The OrchestralLily package [Kainhofer, 2010b] 
is currently dual-licensed under the Creative 


Commons BY-NC 3.0 license [Creative Com¬ 
mons, 2010] as well as under the the GPL v3.0. 

Its source code can be found in a public git 
repository [Kainhofer, 2010a]: 
http://repo.or.cz/w/orchestrallily.git. 

More information about the OrchestralLily 
package can be found in the documenta¬ 
tion at its homepage http://kainhofer.com/ 
orchestrallily/ (which is unfortunately not 
always kept up to date) or better directly from 
the source code. 
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